home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / uother__ / 11730b01.ziv / SHELL22.EXE / SHELL.HLP < prev    next >
Text File  |  1994-05-31  |  39KB  |  1,052 lines

  1. <Iconshell manual summary>
  2. ....Please click on a title to go to the chapter
  3.  
  4. QUICK REFERENCE
  5.  
  6. DESCRIPTION OF AN ICON
  7. SELECTING AND VIEWING ICONS
  8. MOVING ICONS
  9.  
  10. CHANGING PAGE OF FILE ICONS
  11. SELECTING FILES THE DESKTOP DISPLAYS
  12. CHANGING DRIVE
  13.  
  14. LAUNCHING A PROGRAM
  15. ASSOCIATING A COMMAND WITH A FILE
  16. THE RUN ICON
  17.  
  18. PULL-DOWN MENU
  19. THE DISK DIRECTORY WINDOW
  20. DESCRIPTIONS OF FILES: THE SHELL.EXT FILE
  21. SENDING DIRECTLY DOS COMMANDS
  22. TO QUIT Iconshell
  23.  
  24. CREATING AN ICON WITH THE INSTALL COMMAND
  25. ADDING, MODIFYING, DELETING AN ICON
  26. THE COMMAND FIELD
  27. THE PROGRAM FIELD
  28. OPTIONS AND VARIABLES
  29.  
  30. SETUP
  31. COLORS
  32. PICTURE ON BACKGROUND
  33. TO MOVE OR CHANGE SIZE OF A WINDOW
  34. RESTORING THE STANDARD DESKTOP
  35.  
  36. LOCK/UNLOCK
  37. RENAMING FILE/DIR
  38. MOVING FILE
  39. MAKING DIR
  40. DELETING FILE/DIR
  41. FILE/DIR COPY
  42. DISK COPY
  43. DISK FORMAT
  44.  
  45. PHANTOM FILENAMES
  46. BOARD.EXE
  47. TEXT FILE VIEWING
  48.  
  49. DISK COMMANDS
  50. SWTOOLS
  51. HOW TO MAKE A NEW DESKTOP
  52.  
  53. SUMMARY OF COMMAND KEYS
  54. PROBLEMS AND OFTEN ASKED QUESTIONS
  55. HOW TO CREATE IMAGES FOR ICONS
  56. ABOUT THE GRAPHICAL INTERFACE
  57.  
  58. <Other programs>
  59. SHELLR.BAT
  60. SE.BAT
  61. DISKCOPY.BAT
  62.  
  63.  
  64. QUICK REFERENCE
  65.  
  66. SELECT    an icon, use the cursor keys or click once the left mouse button.
  67. LAUNCH    select an icon, press ENTER or click twice.
  68. VIEW      content of an icon, press 'v'.
  69. INSTALL   an icon, select a file or directory and press 'i'.
  70. ASSOCIATE to launch a program with files, type '+' or click the right
  71.           mouse button, select first the program, and then each file.
  72. MENU      press ALT and underlined letter together.
  73. READ TEXT press 'r'
  74. ARCHIVE   to view an archive in the directory window type ENTER
  75. DRIVE     press A..F, with uppercase, to change drive.
  76. ICONS     the space bat toggles display of installed or file icons.
  77. MASK      to select files displayed as icon, use the 'b' command.
  78. RESTART   Iconshell when exiting a program, requires:
  79.           - loaded by SHELLR
  80.           - proper option on in setup,
  81. COLORS    if color or setup changed, press F2 to keep the changes.
  82. QUIT      Iconshell, press F3 or q.
  83.  
  84.  
  85. OVERVIEW
  86.  
  87. Iconshell  is a useful DOS interface that make good use of the power of
  88. current  computers to a friendlier  access  to  softwares and commands.
  89. The  keys  and  mouse  usage  is close to that of Windows (c), allowing
  90. using the two softwares but learning only one user interface.
  91.  
  92. FEATURES OF Iconshell
  93.  
  94. - It displays software and command as icons.
  95. - Allows automatical installation into icons.
  96. - Store options and variables with filenames.
  97. -  Allows to associate icons together with two clicks, to launch a pro-
  98. gram with a file, or to execute a command with files.
  99. - Has file management at the menu: copy, format, and so on.
  100. -  A  directory  window  and a special added program to  easily sail in
  101. directories.
  102. - A function to search a file on a disk.
  103. - A built-in file viewer, keyboard or mouse driven also.
  104. - Displays content of ZIP and LZH archives.
  105. - and it remain a very short program with all these features.
  106.  
  107. Iconshell  displays the current disk directory either as icons or text,
  108. and  programs    can  be executed with the single click of the mouse on
  109. the icon or the filename.
  110. Automatical  installation of the filenames and their path is  also  al-
  111. lowed to run them further without the search in disk sub-directories.
  112.  
  113. Until  30  icons  can  sit  on  a desktop and each of them can store in
  114. data  fields  all  DOS  commands, filenames and following options  that
  115. are  typed  to run a software in order. Complex line commands no longer
  116. require  to  refer  at  the  manual, but once to install them. User can
  117. create unlimited number of desktop.
  118.  
  119. Some  commands  are  already installed, that are only examples, you can
  120. change them and add so much that you want.
  121.  
  122. Finally,  the  functions  of  Iconshell,  are all these  you install in
  123. icons, including all DOS commands.
  124.  
  125.  
  126. DESCRIPTION OF AN ICON
  127.  
  128. To  see  the  data  inside  an icon, select it with the cursor keys and
  129. press  the  'v'  key.  A green  window  shows the title, the image, the
  130. command and program fields.
  131.  
  132. First  of  all,  please  to  remember  the difference between a command
  133. icon,  that is an installed icon with data fields, and a file icon that
  134. is a file displayed as icon on the desktop.
  135. When I say only 'icon' that's referring to an installed icon.
  136.  
  137. An  icon has an image and a title and has two data fields not displayed
  138. on the desktop:
  139. - the COMMAND field for DOS commands, and
  140. - the PROGRAM field for a program with his path and options.
  141.  
  142. The  command  field  gets  DOS commands, which will be executed without
  143. leaving  Iconshell, as  for example, a directory change before to run a
  144. program.
  145. It can also get a batch filename, a COM or EXE program.
  146.  
  147. When  one  click  on  an icon, Iconshell always first performs the com-
  148. mand field, and then the program field.
  149.  
  150. The  program field  gets  the name of a program to run, with EXE or COM
  151. extension, and its options.
  152.  
  153. Here are two examples of data fields:
  154.  
  155. Example:           Title: Word x.x
  156.                    COMMAND: cd \word
  157.                    PROGRAM: word mytext.doc
  158.  
  159. Example:           Title: Unpack
  160.                    COMMAND:
  161.                    PROGRAM: \tools\unpack a: \(file.pak) -x2
  162.  
  163.  
  164. SELECTING AND VIEWING ICONS
  165.  
  166. Use  the  cursor keys to move the cursor on an icon, then its title be-
  167. comes  highlighted, press ENTER to execute it, or type a command key to
  168. apply a function on this icon.
  169.  
  170. Using  a  mouse,  move the mouse cursor on the image or the title of an
  171. icon, and  click once to select this icon, click again to execute it.
  172.  
  173.  
  174. MOVING ICONS
  175.  
  176. Press  'm'. The title  of the current icon is now displayed with a yel-
  177. low  background.  Move  the  icon selection bar with the cursor keys to
  178. a  new location, and press 'm' again or press ENTER, the icon will move
  179. to this new location.
  180. With the mouse, select an icon and click on the 'move' option in the
  181. pull-down menu, and repeat to move, or click on the ESC key at right
  182. of the title bar to cancel.
  183.  
  184.  
  185. CHANGING PAGE OF FILE ICONS
  186.  
  187. When  one  move  the  mouse  pointer  on  the left or right side of the
  188. screen,  the  mouse become an horizontal arrow. Click then to display a
  189. previous  page  of  file icons that symbolically is at the left, or the
  190. next  page  that  is at the right. The Page Up key, to view next files,
  191. and  Page  Down  key,  to view previous file, do the same with the key-
  192. board.
  193.  
  194.  
  195. SELECTING FILES THE DESKTOP DISPLAYS
  196.  
  197. Press the 'b' key to access the dialog box.
  198. Press  in    order  'e',  'c',  'b',  't', 'd' to select/deselect files
  199. with  EXE, COM, BAT extension, others files or directories. Press ENTER
  200. to exit.
  201.  
  202.  
  203. CHANGING DRIVE
  204.  
  205. At  bottom  left  of  the  screen,  icons figure each available logical
  206. unit.  Logical  unit  is  all that MS-DOS recognizes as unit, including
  207. the pseudo B drive, virtual disks, and SUBST commands.
  208. To  change  for  a  unit, click on a unit icon or press the letter with
  209. the shift key held down .
  210.  
  211. The  B  unit  is  always displayed, if  here is no physical second disk
  212. drive  present,  MS-DOS  creates a logical B unit and redirects the ac-
  213. cesses to the physical drive A.
  214. You can yourself define logical unit by using the SUBST command.
  215. For example:   SUBST E: C:\WORK
  216. Iconshell displays then an E disk icon.
  217.  
  218.  
  219. LAUNCHING A PROGRAM
  220.  
  221. Select  an  icon  and  press  ENTER  or click twice on the icon. If the
  222. program  needs  variables  to be entered when one loads it, it will ask
  223. you  to  type  them int a dialog box. One may also click on the program
  224. name in the directory window to execute it.
  225.  
  226. Another  way to give parameters is the association, that is detailed in
  227. the  following  chapter.  Before  one  speaks  about  association,  get
  228. clearly in mind the difference between the two methods:
  229. -  one  clicks  the  LEFT  mouse button or one presses ENTER to run the
  230. program displayed as icon.
  231. -  one  clicks  the RIGHT mouse button or one presses '+' to run a pro-
  232. gram  with  association  of one or more other icons of files as parame-
  233. ters.
  234.  
  235. When  the program launched ends, one returns to DOS or Iconshell is re-
  236. loaded,  according  to  the  chosen option. To return to Iconshell, two
  237. things are necessary:
  238. 1)  Iconshell  must to have been loaded with the SHELLR command, either
  239. at the prompt line or by the AUTOEXEC.BAT file.
  240. 2)    The  option  'Self-reloading'  must to be set on, it is the first
  241. line of the setup window.
  242.  
  243. Sometimes,  to  return to Iconshell is not desirable. Some programs mo-
  244. dify  the  timer  of the computer that change the time and date. Others
  245. erase  the  drivers  that  reside in memory. On must to boot the system
  246. after  these  programs,  but  it is very useful to reload automatically
  247. the DOS interface when one runs short programs often used.
  248.  
  249.  
  250. TO ASSOCIATE A COMMAND AND A FILE
  251.  
  252. Commands  in  the disk sub-menu are performed on the currently selected
  253. icon,  if  a  file  icon,  that  is a kind of association. One may also
  254. associate  an icon  that holds a command with variable filenames in pa-
  255. renthesis,  with  file  displayed  as icon on the desktop. The filename
  256. will replace the string in parenthesis.
  257.  
  258. One  tags  first  the  command icon by a press on the '+' key, then one
  259. tags one or more file icons by selecting them and pressing again '+'.
  260.  
  261. With  the  mouse, one clicks once on a command icon with the right but-
  262. ton  (the  mouse  pointer  become  a cross), and then one clicks on the
  263. icons of the file icons in order.
  264. When  one  has selected the first icon, its content is displayed at the
  265. bottom  of  the screen. And when on select the following icons, the re-
  266. placement of the strings in parenthesis appears simultaneously.
  267.  
  268. If  the  first  icon does not hold variables, the icon is simply selec-
  269. ted, nothing appears.
  270. When  all variables are replaced by filenames, the command is automati-
  271. cally performed.
  272.  
  273. Example: To load the program EDIT.EXE with the file TEXT.TXT:
  274.   The  installed  icon  EDIT  must  have  a  variable  in  parenthesis,
  275. as for example:   EDIT (file)
  276.   Select the installed icon EDIT, press '+', then select  the file icon
  277. TEXT, press '+' again.
  278.   EDIT  (file)  is replaced by EDIT TEXT.TXT... and the command is per-
  279. formed.
  280.  
  281. Example: An icon holds the command  CD \(dir)
  282.   Selects  this  icon and press '+', the command  will be  displayed at
  283. the  bottom  of  the  screen.  Then select an icon of a directory, 'my-
  284. dir',   for example, and press '+' again:  CD \mydir  will then be dis-
  285. played, and the directory change is processed.
  286.  
  287.  
  288. THE RUN ICON
  289.  
  290. The  SHELL desktop holds an icon that has the RUN command installed in-
  291. to.  This is an DOS extension, included into the Hlist & Plus software,
  292. from  the  same  author,  and  that  is  given as a bonus to registered
  293. users.  This  command  searches for a program in the whole disk, change
  294. directory,  and  run the program. It's only needed to click on the icon
  295. and type the name of the program to search.
  296.  
  297.  
  298. PULL-DOWN MENU
  299.  
  300. To access the menu, hold down the ALT key and press a key among F,
  301. I, O, D, U. These letters are underlined on the menu bar.
  302. Press ENTER or the down cursor key to display a sub-menu.
  303. Use cursor keys to move the selection bar or to change sub-menu.
  304. Press ENTER to execute the command. If this command must apply to
  305. an icon, it will apply to the currently highlighted one.
  306.  
  307. Each  option has  a shortcut key, that is either underlined or shown at
  308. the right of the command.
  309. Press ESC to quit the sub-menu or the menu.
  310.  
  311. Using mouse:
  312. Do  a  mouse click on the menu bar to active it, click on a line of the
  313. sub-menu to execute the function.
  314.  
  315. There are three buttons on the title bar.
  316. - The leftmost button is for displaying the version number,
  317. -  the second at left that shows a double arrow toggles between icon or
  318. directory display,
  319. -  the one at right, that shows a diamond, replaces the ESC key for the
  320. mouse.
  321.  
  322. Summary of pull-down menu command:
  323.  
  324. Files
  325.  Directory:    Display the current directory.
  326.  Run:          Execute an icon.
  327.  Board mask:   Select files to display on the desktop: EXE,  COM, BAT,
  328.                dir or data (all others).
  329.  Dos command:  Execute directly DOS commands.
  330.  Help:         List essential commands.
  331.  About...      Display copyright, current version and date.
  332.  Exit:         Return to DOS.
  333.  
  334. Icons
  335.  View:         Display fields of a resident icon.
  336.  Install:      Create a resident icon from a file icon.
  337.  Add:          Opens a dialog box for resident icon creation.
  338.  Change:       Change fields/image of a resident icon.
  339.  Delete:       Remove an installed icon of the board (not the files).
  340.  Move:         Reorganize the desktop.
  341.  
  342. Options
  343.  Setup:        Change configuration.
  344.  Colours:      Open the window for preferences setting.
  345.  Save config:  Save changes made on display (changes on resident
  346.                icons are automatically saved).
  347.  Std desktop:  Retrieve all defaults: colours, window sizes,
  348.                etc...
  349.  
  350. Disk
  351.  Lock file     Protect a file against deletion.
  352.  Rename        Rename currently selected, highlighted, file or
  353.                directory, or move it elsewhere on the disk.
  354.  Make dir      Create a new sub-directory.
  355.  Del           Delete the highlighted file or directory if empty.
  356.  Copy          Copy a file or a directory and its sub-directories.
  357.  Disk copy     Copy a disk.
  358.  Format        Format a disk.
  359.  
  360.  
  361. Utilities
  362.  Where is      Search for a filename or pattern anywhere on a given
  363.                drive.
  364.  Read file     Display a text file.
  365.  
  366.  
  367. THE DISK DIRECTORY WINDOW
  368.  
  369. The  'd'  command    allows  a larger disk directory list that is dis-
  370. played  as  text  inside    a window. Filenames have black letters, and
  371. sub-directories red letters.
  372. Files  are    displayed    according  to the mask specified by the mask
  373. setting  and  that is displayed as yellow squares on the window's title
  374. bar.
  375. When  the squares are yellow, the file having this extension are inclu-
  376. ded in the list. Simply click on the squares to change the setting.
  377. The shortcut keys are these:
  378. - e: for EXE files.
  379. - c: for COM files.
  380. - b: for BAT files.
  381. - t: for all other files.
  382. - d: for directories.
  383.  
  384. Other commands in the directory window:
  385. - ESC: exits, returns to board of icons.
  386. - cursor keys, to select or scroll.
  387. - ?: Display more info: show file size and date, press ? again
  388.      to return to condensed display.
  389. - r: view the file.
  390. - A..F (uppercases) change drive.
  391. - ENTER: acts on the highlighted entry,
  392.    > if a directory, performs a change dir.
  393.      The '..' sub-directory returns to the previous level.
  394.    > if a program (EXE, COM, BAT), runs it.
  395.    > if an archive (ZIP or LZH), displays it's content.
  396.      Press ENTER again to return to directory.
  397.    > otherwise, ENTER calls the file viewer.
  398. -    ALT-SPACE: open the menu, then cursor is used to move or to change
  399. the size.
  400.  
  401. Using  mouse,  click  once on an entry to select it, or use the lift at
  402. the  right  of the window, and click twice to replace 'ENTER'. To exit,
  403. do a mouse click out of the window.
  404.  
  405. This function shows up to 256 file or directory names.
  406.  
  407.  
  408. DESCRIPTIONS OF FILES: THE SHELL.EXT FILE
  409.  
  410. If  the extended directory option is chosen, the window display the si-
  411. zes,  dates,  and  a short description of the file according to its ex-
  412. tension.
  413. These  descriptions  are  stored inside the SHELL.EXT file, that may be
  414. edited  by  the  user with any text editor. A line may be until 44 cha-
  415. racters  long, and start with the three letters extension followed by a
  416. space.
  417. Until  32  lines  may be included in the file, if a registered version.
  418. The  unregistered  version holds only 8 lines and allows only to change
  419. existing descriptions.
  420.  
  421.  
  422. SENDING DIRECTLY DOS COMMANDS
  423.  
  424. Press 'o', and type a DOS command into the dialog box.
  425.  
  426.  
  427. TO QUIT Iconshell
  428.  
  429. Press    'q'    to  exit  and save options of the display (windows, co-
  430. lours,    ...)    as  they  are  not stored in the CFG file until there
  431. is  change  relating  to icons or the F2 key is pressed.
  432.  
  433. Press F3 to exit without saving the last changes.
  434. Alternate keys to F3: ALT-F4, ALT-X.
  435.  
  436. To  do  a  mouse click on the diamond at right of the title bar, is the
  437. same that pressing the F3 keys.
  438.  
  439.  
  440. CREATING AN ICON WITH THE INSTALL COMMAND
  441.  
  442. Installation  avoids  to   search a program in a sub-directory, and al-
  443. lows to put the options at command line if required.
  444.  
  445. Move  the    cursor    on  the file icon on the desktop and type 'i'. A
  446. dialog  box  displays the content of the future resident icon when ins-
  447. talled:
  448. - title, that is the node of the filename,
  449. - a change drive and directory command,
  450. - the program name.
  451. You may edit these data now. Press ESC to cancel.
  452.  
  453.  
  454. ADDING, MODIFYING, DELETING ICONS
  455.  
  456. To  add  a  new  Icon,  press 'a'. A dialog box will appears. This  box
  457. shows  an image of icon that is the first in buffer, you may choose the
  458. image with the PAGE UP/DOWN keys.
  459.  
  460. To  change   line,  use the up/down cursor keys. Don't press ENTER when
  461. a  field  is  filled.    All  that  is  on  the  screen  is also in the
  462. memory,  and  the ENTER key serves to save data and to close the dialog
  463. box...  One  may also click  on  the  'Get' button to save and quit. Or
  464. one may press ESC or click on the Cancel button.
  465.  
  466. The  title  can  be  16 letters long, other fields have size limited by
  467. the  window  width,  and they are specially described in the two follo-
  468. wing paragraphs.
  469.  
  470. The  windows  can    be  enlarged by a press on the ALT-SPACE key, or a
  471. mouse  click  on  the  borders (See later for details of that).
  472.  
  473. To  modify an existing icon, the    command   is:  'c'. Then, there  is
  474. no difference with the 'add' or 'install' function.
  475.  
  476. To  delete  an  installed icon, press  DEL,  and  confirm  by  a  press
  477. on  the 'y' key or a mouse click on the Ok button. To cancel, press 'n'
  478. or ESC or click on the Cancel button.
  479.  
  480.  
  481. THE COMMAND FIELD
  482.  
  483. This  field gets any DOS command as typed on the DOS line command.
  484. Starting  MS-DOS  version   5, one can chain several commands separated
  485. by '|' symbol.
  486. If  the   field remains  blank, the program ignores it when the icon is
  487. selected.
  488. A  batch  filename (BAT), a program with COM or EXE extension are valid
  489. commands.
  490. One  must  verify  that the process  will  not  have memory action that
  491. can  erase Iconshell, as it remains in memory when the COMMAND field is
  492. performed.
  493. The  program  must run  in remaining memory, that is 400-500k according
  494. to the configuration.
  495.  
  496. If  the command uses variable data, put a string in parenthesis for re-
  497. placing  at  the  execution time or for association.  When one click on
  498. the  icon  with the left mouse button, Iconshell opens a dialog box for
  499. the  replacement  of the string, when one clicks with the right button,
  500. Iconshell  wait  for another click on an icon of file, and it makes the
  501. replacement of the string by the filename with the path.
  502.  
  503.  
  504. THE PROGRAM FIELD
  505.  
  506. The  program  field  gets  a    program name with 'EXE', 'COM' or 'BAT'
  507. extension. One may set the path of the file.
  508.  
  509. This   field  can  remain  blank if the icon represents only a DOS com-
  510. mand.
  511. The program  name (but BAT file) can be followed by several parameters
  512. until  a  maximum  of  7, separated by a space. The first parameter can
  513. be  separated  of the name by '/', if this is a correct syntax for this
  514. program.
  515.  
  516. Example, to execute Windows in standard mode:       win/s
  517.  
  518. The  program field as the command field allows string to replace at the
  519. execution time.
  520.  
  521. Including  substituting strings the fields can be  until 160 characters
  522. long.
  523.  
  524.  
  525. OPTIONS AND VARIABLES
  526.  
  527. Some  programs as PKUNZIP, LHA, have many parameters including filename
  528. that  change  each  time, so to avoid often to type their complex  syn-
  529. tax, Iconshell allows  strings to replace that are in parenthesis.
  530.  
  531. When the icon will be performed, Iconshell will ask for replacement.
  532.  
  533. a) Example of replacement for the command fields.
  534.  
  535.          COMMAND: cd \(directory)
  536.  
  537. When one does a mouse  click on this icon a message is displayed:
  538.  
  539.          Replace or press ENTER to keep
  540.          directory.....................
  541.  
  542. If  one types for example, 'windows', the string is replaced and paren-
  543. thesis are removed,  that will produce the following result:
  544.  
  545.          cd \windows
  546.  
  547. If  one presses only ENTER, the string that is the default remains, and
  548. this produces:
  549.  
  550.          cd \directory
  551.  
  552. b) Example of replacement for the program field.
  553.  
  554.          PROGRAM: unpack -t a:(SOURCE) (DESTINATION)
  555.  
  556. At the click on the icon, Iconshell asks:
  557.  
  558.          Replace or press ENTER to keep
  559.          SOURCE........................
  560.  
  561. Type for example:
  562.  
  563.          MEGAPROG.PAK..................
  564.  
  565. Iconshell then asks:
  566.  
  567.          replace or press ENTER to keep
  568.          DESTINATION...................
  569.  
  570. Type for example:
  571.  
  572.          c:\temp.......................
  573.  
  574. Substitutions will produce the following result:
  575.  
  576.          unpack -d a:MEGAPROG.PAK c:\temp
  577.  
  578.  
  579. SETUP AND DISPLAY
  580.  
  581. SETUP
  582.  
  583. Type 'u' to open the setup dialog box.
  584.  
  585. Following option may be changed:
  586.  
  587. Automatically return to Iconshell
  588.  Type 'a' to switch the selection.
  589. The  self-reloading  will  work  only if Iconshell has been load by the
  590. SHELLR command.
  591.  
  592. Screen resolution.
  593.  The desktop may have two screen resolutions:
  594. - the medium resolution, or EGA, or VGA 16.
  595. - the high resolution or VGA 18, 640 x 480 pixels.
  596.   Press  's' to change this option. The high resolution allows until 30
  597. installed  icon,  and  one  may  not switch to the medium resolution if
  598. more than 20 icons are created.
  599.  
  600. Background picture
  601.   The  registered version allow display of an VGA or EGA 16 colors pic-
  602. ture  as  background.  Press the 'p' key to select/deselect the display
  603. of the picture. That can also be done from the desktop.
  604.  
  605. Display of current path and available disk space.
  606.  Press 'f' to change.
  607.  
  608. Display file icon on the remaining space on the desktop.
  609.  Press 'i' to change.
  610.  
  611. Display either installed icons or file icons only.
  612.  Press 'o' to change.
  613.  From the desktop press SPACE to change.
  614.  
  615.  
  616. COLORS
  617.  
  618.   To  change  the  colors  of the desktop, press the F5 key to open the
  619. dialog  box, then select an item  with  the TAB key or vertical arrows,
  620. and  click  on  a  color or use the horizontal arrows cursor to move to
  621. the chosen color.
  622.  
  623.  The police for icon titles may be changed by pressing the 'f' key.
  624.  
  625.   A  new  color  may  be created for the desktop background.  Just do a
  626. click  on  the  buttons  at  left or right of each of the three colored
  627. squares,  that  represent  the RGB, red, greed, blue registers. On key-
  628. board the following keys may be pressed instead: r, R, g, G, b, B.
  629.  
  630.   Title  bar  and    background of windows can be directly changed when
  631. they  are opened, with ALT-b and  ALT-h or by selecting the window menu
  632. with ALT-SPACE, and then using 'b' or 'h' commands.
  633.  
  634.   To  restore  all defaults press 'z'. All  changes relating to display
  635. will  be  cleared  and the initial  desktop  restored. Changes on icons
  636. are  preserved however. To forget  all changes including  icons,  erase
  637. the file SHELL.CFG, it will be rewritten with default icons.
  638.  
  639.  
  640. TO MOVE OR CHANGE SIZE OF A WINDOW
  641.  
  642.   If  the  window has a button with a 'w' letter in the upper left cor-
  643. ner,  it  has  a  system menu that holds the 'move' and 'size' options,
  644. one  presses  ALT-SPACE to get the menu. If the window doesn't have the
  645. button,  to  press  ALT-SPACE goes directly to the move/size mode and a
  646. dotted rectangle appears.
  647.   With  the  mouse,  if  moving  is  allowed,  the mouse cursor becomes
  648. four  arrows  when  the  mouse  stays  on the left or top border of the
  649. window.
  650.   If  changing  the  size  of  a window is allowed,  a horizontal arrow
  651. replaces  the  standard  arrow    when   the mouse pointer stays on the
  652. right or bottom  border.
  653.   To  do the change with the mouse, hold down the left button and drag,
  654. then click once the right button to exit.
  655.  
  656.   With  the  keyboard,  when  selecting specifically either the move or
  657. size  option  is  possible,  one uses the cursor keys to do the change,
  658. exactly as in Windows (c).
  659.   Otherwise,  when  it is a dialog box and the ALT-SPACE command sets a
  660. global  change  mode, one uses the cursor keys to move the box, and one
  661. holds  down  the  ALT key and presses the cursor keys simultaneously to
  662. change the size.
  663.  
  664.  There are also alternate keys to change the size:
  665.  '>'  increases width
  666.  '<'  reduces width,
  667.  '+'  increases height,
  668.  '-'  reduces height.
  669.  
  670.  Press ESC or ENTER to exit.
  671.  
  672. RESTORING THE STANDARD DESKTOP
  673.  
  674.   Press  the 'z' key. All changes on the display will be erased and the
  675. standard  desktop  will  be restored. This doesn't clear the changes to
  676. the  icons.  To  retrieve the standard icons, erase the SHELL.CFG file,
  677. il will be rebuilt with the standard icons.
  678.  
  679.  
  680. LOCK/UNLOCK
  681.  
  682. To protect a file against deletion, use the command 'l'.
  683.     Attributes are then displayed as ASHR:
  684.       A: archive
  685.       S: system
  686.       H: hide
  687.       R: read only
  688.   Only  the  'read  only'  attribute can be changed here, for any other
  689. attribute, use the 'o' command.
  690.   Press 'l' or '+' to lock the file, 'u' or '-' to unlock it.
  691.  
  692. RENAMING FILE/DIR
  693.  
  694. To  rename a file or a directory use the 'n' command and type the new
  695. name into the input box..
  696.  
  697. MOVING FILE
  698.  
  699. Moving a file on the same disk is allowed by the rename command also.
  700. Press 'n' and type a new path for the file selected, with the same
  701. or a new name.
  702. Moving a file on another disk is not allowed by this command, but the
  703. MS-DOS or other move command may be installed into an icon. I want
  704. only use commands that may not cause by error lost of file.
  705.  
  706. MAKING DIR
  707.  
  708. To make a directory, use the command 'k'.
  709.  
  710. DELETING FILE/DIR
  711.  
  712. To delete a file or an empty directory, use CTRL+d.
  713.  
  714. FILE/DIR COPY
  715.  
  716.   To copy the currentlry selected file or directory with its sub-direc-
  717. tories,  type 'y', then a window displays  the  directories to the user
  718. selects the destination path.
  719.   One  moves to the proper path, not only one moves the cursor on a di-
  720. rectory  name,  but changes to it, then presses 'y' again to do the co-
  721. py.
  722.  
  723. DISK COPY
  724.  
  725. To  copy  a  disk,  type '$'.  This command run either the DISKCOPY.BAT
  726. file  if  present in the Iconshell directory or the MS-DOS diskcopy.com
  727. command.
  728.   DISKCOPY.BAT  holds  a  generic program name, 'diskdup' that copies a
  729. disk  in  one  pass  by  storing the disk image on a hard drive. If you
  730. don't  own  a  program of this kind, simply erase the DISKCOPY.BAT file
  731. and  the  MS-DOS  command  will  be directly called. Of course, you may
  732. edit  DISKCOPY.BAT to put another name for the one-pass duplicator, as-
  733. suming  it requires as first parameter the name of the disk to copy and
  734. as  second parameter the name of the unit to store the disk image. Some
  735. programs  use  another  syntax  and  you must deal with it to adapt the
  736. batch file.
  737.   One  may choose the option 'DOS diskcopy' that is for a standard copy
  738. using  the  MS-DOS  diskcopy.com  program,  or 'Disk image', for a copy
  739. with a one-pass duplicator.
  740.    In both cases one selects with the Source button the disk drive that
  741. holds  the    disk  to copy. In the DOS diskcopy case, one selects with
  742. the  Target  button  the  disk drive that holds the backup disk. In the
  743. second  case, one selects with the Image button the unit where the disk
  744. image is temporary stored.
  745.  
  746. DISK FORMAT
  747.  
  748. To  format  a disk, type 'f', then select either the drive A or B, by a
  749. press  on  the  'd'  key,  and  select the DOS format method for a 1.44
  750. disk:
  751. -  Certify:  this  is  the  standard format command. The DOS format the
  752. disk and verify each sector.
  753. -  Quick:  this  corresponds   to  the  /Q  option of MS-DOS that clear
  754. only the FAT and directories.
  755.  
  756.   For  other  options or other kind of disk, some examples of icons are
  757. provided on the Disk command desktop.
  758.  
  759.  
  760. PHANTOM FILENAMES
  761.  
  762. 'Phantom  files' are  programs integrated to Iconshell, that can sit in
  763. the command or program field, as programs on disk.
  764.  
  765. There are currently:
  766.  
  767. EXIT.EXE  Its action is to return to DOS.
  768. QUIT.EXE  saves display changes and return to DOS.
  769. WAIT.EXE  waits  for  a key press. Useful when a command displays some-
  770. thing just before to exit.
  771. BOARD.EXE  with  CFG  filename  as  parameter,  allows  loading  a  new
  772. desktop.
  773. CLOCK.EXE Displays the time.
  774. DIRECTORY Shows the current disk directory in a window.
  775. CDD       Change drive and directory.
  776.  
  777. If    by  chance  one  wants  to put real program with the same name in
  778. a  fields  of  an  icon,  or    same  name  with  'COM'  extension, one
  779. must  specify  the  path  (for  example: C:CDD.COM), and Iconshell runs
  780. the  file   from disk rather to execute the phantom programs.
  781.  
  782.  
  783. BOARD.EXE
  784.  
  785. This  integrated  program  allows  multiple desktops. One uses the  'a'
  786. command  to  create a new icon, fills the command field, for example:
  787.  
  788.      BOARD.EXE  C:\MYBOARD.CFG
  789.  
  790. Then  a click on this icon will display until 30 new icons. There is no
  791. limit  but  the  disk size to the number of boards. It is preferable to
  792. put   the complete path of the config file, as the icon can be selected
  793. from another sub-directory.
  794.   The  registered  version  recognizes  a second parameter to a file of
  795. icon  images, a background picture, and a file of icons, as extra para-
  796. meters, in order.
  797.  
  798.  
  799. WHERE IS
  800.  
  801. Locate a filename.
  802. Use the command 'w'.
  803. Search    for  a  filename or pattern in a whole drive, starting at the
  804. root directory.  ESC can abort the process.
  805.  Examples:   c:*.exe
  806.        or    a:FILENAME.EXE
  807.        or    FILENAME.EXE
  808.        and so on...
  809.  
  810.  
  811. TEXT FILE VIEWING
  812.  
  813. To  display the content of a file on the desktop, press the 'r' key, or
  814. simply ENTER, but for a file with BAT extension.
  815. The  built-in  viewer  may  read files having 32767 lines, and up to 32
  816. megabytes.  However,  the  more  the size increases, the more the speed
  817. slows  down, it is in fact intended to easily read all these short text
  818. files you often find around, including the Iconshell's help file.
  819.  
  820. Commands are these:
  821. ESC:          exit.
  822. Cursor  key:  scroll up or down a line, or move horizontally the win-
  823.               dow on the text.
  824. Page up:      display previous screen page.
  825. Page down:    display next screen page.
  826. HOME:         jump to start of file.
  827. END:          jump to end of text in memory.
  828. t:            change text and background color.
  829.  By  a  mouse  click on a  button upon the text window one passes the
  830. same commands.
  831.  
  832.  
  833. DISK COMMANDS
  834.  
  835. DOS  disk  commands  are  available  either  within the menu, or on the
  836. desktop.  Commands  in  the menu are special improved built-in commands
  837. or   simply  those  of  DOS, as Iconshell is a shell to DOS.
  838. File  and  disk    copy,  format, use the DOS commands with a graphical
  839. interface to make them friendly.
  840.  
  841. MD  Make a directory.
  842.     Use the command 'k'.
  843.  
  844. DEL Delete a file or an empty directory.
  845.     Use CTRL+d.
  846.  
  847. REN Rename a file or a directory or move a file in another directory.
  848.     Use 'n' and type the new name, and optionally type a new path.
  849.  
  850. LOCK Protect a file against deletion.
  851.     Use the command 'l'.
  852.  
  853. COPY Copy a file or a directory with its sub-directories.
  854.      Use 'y' to copy the selected file or directory, then a window dis-
  855. plays  the  directories to you select the destination path.
  856.  
  857. DISKCOPY Copy a disk.
  858.   Type  '$'.   This command run either the DISKCOPY.BAT file if present
  859. inside  the  same  directory  that  Iconshell, or otherwise the MS-DOS'
  860. DISKCOPY.COM command.
  861.  
  862. FORMAT  Format a disk.
  863.     Type  'f' for a standard format, for other options or other kind of
  864. disk,  some  examples of icons are provided on the 'Disk command' desk-
  865. top.
  866.  
  867. CHKDSK Checks a disk for correct allocation.
  868.    Use the icon CHECK DISK.
  869.  
  870. MEM Views memory.
  871.    Use the icon MEM from MS-DOS version 5, of CHKDSK otherwise.
  872.  
  873.   All  other commands described in the DOS manual can be installed into
  874. icons also.
  875.  
  876.  
  877. SWTOOLS
  878.  
  879.   In the shareware market, there are plenty of new improved useful com-
  880. mands  to  enhance the DOS base system.   Some examples are already ty-
  881. ped on the SWTOOLS desktop:
  882. - Pkunzip    (c) PKware.
  883. - Arj        (c) R.K. Jung.
  884. - Lha        (c) H. Yoshizaki.
  885. - Diskdup    (c) R. K. Snyder.
  886. - V-Scan     (c) McAffee Associates.
  887. - Run, go    (c) D.G. Sureau.
  888.  
  889.   Many  other  commands  may be installed in the same way, that you may
  890. find  at  shareware distributors and BBS.  These programs generally re-
  891. quire one pays a licence to use them.
  892.  
  893.  
  894. HOW TO MAKE A NEW DESKTOP
  895.  
  896. The  program    comes  with  some CFG files that contains desktop data.
  897. Creating  a new CFG file is easy and done with the following steps:
  898.  
  899. 1) Add a new icon, with these data into the program field:
  900.         BOARD.EXE  C:\MYBOARD.CFG
  901. BOARD.EXE  is  the 'phantom' program that loads an alternate desktop.
  902.  
  903. 2) Click twice on this new icon. An error message is displayed,
  904.   'File no found: MYBOARD.CFG'
  905. This  is normal, the  program  attempts  to load it, does not found it,
  906. then  restarts  with  default desktop. Note  that  the  name 'MYBOARD',
  907. without extension, is now displayed on the title bar.
  908.  
  909. 3)  To make a new desktop, remove the icons you don't want to keep, and
  910. add those you want.
  911.  
  912. To  make  a  link  with  the  main  desktop, you may add  an icon  with
  913. BOARD.EXE C:\SHELL.CFG into the program field.
  914.  
  915. Note  that  these  paths are only for examples, any drive and directory
  916. may rather be used.
  917.  
  918. Another  simple  method to create a new desktop is running Iconshell at
  919. the  DOS  prompt with the name of the new board as parameter. A message
  920. display  "file  not found", that you ignore, and the program start with
  921. the  default  board of icons with the name you have typed as title. You
  922. will  further save the new desktop with F2, and add an icon to make the
  923. links from the main desktop to the new one.
  924.  
  925.  
  926. SUMMARY OF COMMAND KEYS
  927.  
  928. F1             Display the help screen.
  929. h              Display the copyright, version, date.
  930. Cursor keys    Select icon, sub-menu, etc...
  931. ESCAPE         Leave current function, window, menu, etc...
  932. ENTER          Execute a function.
  933. +              Launch a program by association with one or more
  934.                files.
  935.  
  936. SPACE BAR      Toggle to installed icons or disk directory
  937.                on the desktop.
  938. HOME           Jump to the first file.
  939. PG up/down     Scroll files on the desktop.
  940.  
  941. v or END       Show the content of an icon.
  942. i              Install currently selected file as icon.
  943. a              Add an icon.
  944. c              Change an existing icon.
  945. DEL            Remove an icon.
  946. m              Move an icon ('m' to select icon, 'm' again to
  947.                drop).
  948.  
  949. ALT+key        Get sub-menu or changes a color in desktop.
  950. o              Execute directly DOS command.
  951. d              Show directory. (+ ENTER to run a program).
  952. b              Set desktop directory mask.
  953. Shift-A..F     Change drive.
  954.  
  955. w              Find path of a filename.
  956. l              Lock a file.
  957. n              Rename a file or a directory.
  958. k              Create a new directory.
  959. y              Copy a file, or a directory.
  960. $              Copy a disk.
  961. f              Format a disk.
  962. CTRL-d         Delete the selected file or directory.
  963. r              Display a file as ASCII.
  964.  
  965. u              Open the setup dialog box.
  966. F5             Open the dialog box for colors change.
  967. F2             Save the preferences.
  968. s              Change screen resolution.
  969. p              Set/Reset picture for background (Reg. ver. only)
  970. ALT-SPACE      Change current window.
  971. z              Restore standard settings.
  972.  
  973. q              Save changes and quit.
  974. F3             Exit.
  975.  
  976.  
  977. PROBLEMS AND OFTEN ASKED QUESTIONS
  978.  
  979. 1)  Don't  put  a  resident  program into the COMMAND field, as it will
  980. install  itself in the middle of the memory! Use the Iconshell's reloa-
  981. ding feature to install resident programs and return to Iconshell.
  982.  
  983. 2)  If  any  problem  appears on the Iconshell's display, this probably
  984. comes  from  a  corrupted  CFG  file, or a CFG file that is for another
  985. software.  Installing  Iconshell's  config files into a special sub-di-
  986. rectory  and  setting    the   proper  paths in the icons will fix that
  987. problem.
  988.  
  989. 3)  The  version  1.8 and following are not compatible with older ones.
  990. An  attempt  to load older  CFG file will blank the screen and the pro-
  991. gram  will hang (this  has  no effect on user's files). When installing
  992. the new version,  be careful  to erase all previous CFG files of Icon-
  993. Shell first.
  994.  
  995. 4)  Some  programs    that  are  normally  launched when one puts their
  996. name  in    the    program  field,  can't  be  loaded if one calls them
  997. within  the  command  field.  When  it calls a program from the command
  998. field,  Iconshell  remains    resident    and  the  screen mode remains
  999. graphical.  The  launched  program  may  use a way to display text that
  1000. doesn't  work on a graphic screen, unlike DOS commands. It may also oc-
  1001. curs that the launched program can't fit in the available memory.
  1002.  
  1003. 5)  The  "Out  of memory" message may occur after you use Iconshell, if
  1004. you  have  loaded  directly a resident program. Look at the previous 1)
  1005. paragraph about that.
  1006.  
  1007.  
  1008. HOW TO CREATE IMAGES FOR ICONS
  1009.  
  1010. The  SHELL.SPR   file  holds  33 images that are icons of commercial or
  1011. shareware  softwares for DOS, or symbols of  commands,  and these icons
  1012. are  loaded  or drawn, and stored into a compressed  file  with VIRTUAL
  1013. REALITY TOOLS or SPRITES 18, that are also shareware.
  1014.  
  1015.  
  1016. ABOUT THE GRAPHICAL INTERFACE
  1017.  
  1018. Iconshell  has been written  in C and assembly 80286, using a graphical
  1019. interface  that I have written also. This  interface  is   used  yet by
  1020. V.  R.  Tools,  Sprites 18, Hlist and other programs that are currently
  1021. in  work.  By  using  special  graphical  functions and with always the
  1022. search  of  the simplest algorithm in mind, I write these so short pro-
  1023. gram  that  do  so  much as commercial packages with 1/10 the size. The
  1024. registered  version  of  the software SPRITES 18 now includes a GUI li-
  1025. brary that holds most  features of the Iconshell's GUI.
  1026.  
  1027.  
  1028. SHELLR.BAT
  1029.  
  1030. This  batch  file  allows  Iconshell  is restarted when exiting another
  1031. program launched by Iconshell.
  1032.  
  1033.  
  1034. SE.BAT
  1035.  
  1036. The  purpose  of  this  program  is  going to C: root directory and run
  1037. SHELLR  from any disk and directory. If Iconshell  is  not installed on
  1038. the  c:  drive, SE.BAT may be edited  and the 'c' letter changed to the
  1039. proper drive letter.
  1040.  
  1041.  
  1042. DISKCOPY.BAT
  1043.  
  1044. This  program  serves  to load either the DOS diskcopy command or a re-
  1045. placing  one-pass  program  (not furnished) that stores the disk images
  1046. on  a  hard  drive unit. You may edit this  file to change the name and
  1047. path of programs it calls.
  1048.  
  1049.  
  1050.  
  1051.  
  1052.